Release 10.1A: OpenEdge Development:
Progress 4GL Reference

ATTACH-DATA-SOURCE( ) method

Attaches a Data-source object to a temp-table buffer in a ProDataSet object.

Return type: LOGICAL

Applies to: Buffer object handle

Syntax

buffer-handle:ATTACH-DATA-SOURCE ( datasource-hdl    [ [ [ , pairs-list ], except-fields ], include-fields ] )

buffer-handle

A handle to the temp-table buffer in the ProDataSet object.

datasource-hdl

A handle to the Data-source object.

pairs-list

An optional character expression that evaluates to a comma-separated list of field pairs that specify different names in the Data-source object buffer and the ProDataSet object buffer using the following syntax:

"source-field1,dset-field1 [,source-fieldn,dset-fieldn ] ..."

You can use the ATTACHED-PAIRLIST attribute to retrieve this list of field name pairs.

except-fields

An optional character expression that evaluates to a comma-separated list of fields in the ProDataSet object buffer that will not be populated with data from the data source (that is, fields to exclude). Use this option when it is easier to specify fields to exclude rather than include. You can specify except-fields or include-fields, but not both.

include-fields

An optional character expression that evaluates to a comma-separated list of fields to include in the ProDataSet object buffer, as an alternative to specifying fields to exclude in except-fields. Use this option when it is easier to specify fields to include rather than exclude. You can specify include-fields or except-fields, but not both. If you specify include-fields, you must set except-fields to the Unknown value (?).

See also

DETACH-DATA-SOURCE( ) method